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ABSTRACT 

Over the past several y'>ars, technical communicators 
have been struggling to change some of the stylistic tr^iditions 
inheritbd from scientific discourse. Rhetoricians, writing teachers, 
and psychologists all agree that the use of analogy and first- or 
second-person sentence construction make for more effective 
communication than the absence of analogy and the use of the 
impersonal third person. However, established conventions and 
standards sometimes preclude inserting these stylistic devices into 
our material. With only an intuitive feel for the use of language, 
our arguments lack the substantive basis with which to change the 
standards. In order to examine the discrepancy between theory and 
practice, an experiment with computer documentation was conducted to 
measure the effects of analogy and second-person construction in 
learning, and another to assess whether the'^A same stylistic devices 
were annoying to subject matter experts. The use of analogy made it 
easier for subjects to recall information without being cued; 
however, it had no effect on cued recall (recognition). Computer 
programmers were indifferent to the use of analogy (not hostile), and 
they preferred the second person sentence construction to the third 
person • ( Author/JB ) 
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Analogy and Person 
Within Literature 

The Past: What Rhetorical 
Theory and 
Psycholinguistics Say 
About Analogy 

Rhetoricians since classical times have 
preached the value of consciously and skillfully 
var3ring the stylistic components of 
communication to fit Ihe occasion. Among the 
stylistic components cataloged by Ari»totle, 
analogy appears as a particularly effective 
^trope."^ Tropes, as opposed to schemes, do not 
operate on the metef, rhythmic balance, or 'flow 
of material. Rather, they work through a turn 
of meaning, by drawing parallels or contrasts 
between new ar-' perhaps unfamiliar material 
and similar, familiar concepts already within 
the listener's or reader^s repertoire. 

In this way, rhetoricians and modern 
communicators hypothesize, new material is 
more easily learned, as the student, reader, or 
listener simply attaches the new material to an 
existing conceptual framework. The lengthy 
process of building a new framework for new 
knowledge is bypassed by this ''priming^ 
process. 

As psycholinguists hypothesize, the integration 
of new knowledge into long-term memory is 
hastened by this priming process, by evoking 
existing networks of knowledge into which new 
'^oncepts can be integrated. Clark and Clark 
(1977) discuss what they call the Given-New 
Strategy of communication. If information is 
presented in this optimum manner, relating 
each piece of new information to a piece 
already within the receiver's memory, 
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comprehension will proceed smoothly and 
quickly. If there is no match between given and 
new, according to the Congruence Principle, it 
will take extra processing time to either reject 
the information or construct the bridging 
inferences. 

Not only is learning easier, but retrieval of new 
material from memory is aided when the new 
concepts are attached to common, or densely 
connected concepts. According to Thorndyke 
(1977), we will be able to remember those facts 
or propositions that are central or at a high 
level within the knowledge (memory) hierarchy. 
In his experiments Thorndyke presented 
subjects with four different story conditions. In 
one condition the subjects received a passage 
with a theme statement at the beginning of the 
passage. This theme statement acted as an 
advance organizer, or in other words, it alerted 
the reader as to what to expect. The reader was 
then able to use an elicited framework and 
attach new propositions in the appropriate 
spots. 

In the next condition the theme statement was 
presented at the end of the passage. The reader 
supposedly would have to proceed through the 
material, searching for a relevant framework in 
memory and building a new one if the searches 
were unsuccessful. At the end of the material, 
upon reading the theme statement, the reader 
could conceivably go back and rearrange the 
remembered propositions within the elicited 
framework. However, we would expect the 
cognitive load in this condition to be greater 
than that in condition 1. 

Condition 3 consisted of the passage with no 
theme statement, so the cognitive load would be 
similar to that in condition 2. However, in this 
case, the reader would be left with whatever 
sense wa; made of the material during the 
reading task. Condition 4 had the sentence 
order randomized, thereby violating the 
sequencing of propositions and confounding the 
reader^s ability to generate any framework at 
all. 

Thorndyke found that recall of facts was 
highest when subjects received the theme 
statement at the beginning of the passage. 
Additionally, recall was better with the 
After-theme condition than with the No-theme 
condition. Of course, recall was poorest when 
sentence order was randomized 
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We assiune that the use of analogy as an 
advance organizer offers a particularly effective 
way to minimize the cognitive load demanded 
when learning new material. Through using 
apt analogies we can offer to the reader familiar 
anchoring concepts for unfamiliar ideas. 

The Past: What ^ t^ditions 
in Scientific 

Communication Say About 
Person 

Writing teachers have for many years been 
teaching that using the first person and 
second person *'you*' makes for clearer writing 
than using the third person Tie, she, it, the 
user.*' Evidently, being addressed directly and 
unambiguously precludes the rotation of 
viewpoint that we must make when reading, for 
instance, that ''the user must press ENTER.'' 

Within every* discipUne, however, conventions 
and standards govern much of what is written 
and published. Those within the domain 
become accustomed to literature written in the 
''accepted*' style and seem resistant to any 
variations (not only in theme but in style). 
Despite the fact that cognitive psychologists 
and writing teachers have been teaching that 
human beings read more easily material that is 
in active voice and first or second person, the 
conventions within some disciplines will not 
accept material presented in such a manner. 

Traditionally, scientific communication has 
held to passive voice and third person stylistic 
conventions. The objectivity required by the 
scientific method for studying nature has 
carried over to a tradition of language usage 
that attempts to sterilize the human element 
from the report. However, there is no longer a 
consensus that says that this is necessary or 
even desirable. 

The reporting stage within a scientific endeavor 
is aimed at communicating and disseminating 
knowledge, even at persuading readers and 
listeners. Michael Halloran goes so far as to 
posit that much of Watson and Crick's success 
in presenting their revolutionary views on the 
structure of DNA hinged on their very personal 
and revolutionary usb of language within their 
field. Their scientific papers and manuscripts 
were written in first person, active voice, and 
u.^ed many analogies and examples. The 



language did not obfuscate, but rather, it truly 
explained and communicated. 

There are many who are still steeped in the 
tradition, however. Not more than a few years 
ago, a certain professor was told to revise a 
manuscript, deleting all the direct references to 
the reader and himself; in other worcis, he had 
to re-write the manuscript in third person, 
passive voice. 

The Present: Analogy and 
Person in Informative 
Communication 

Up to this point, we have discussed analogy 
with no reference to the appropriateness or 
concentration of usage within material. In line 
with theory, the effectiveness of an analogy 
depends upon its appropriateness for the 
targeted fiudience. The anchoring concept must 
be something that is indeed familiar to the 
audience. To effectively communicate, the 
content of the analogy must also not be 
offensive to the audience, unless the intent is to 
antagonize. Seldom, probably iiever, should 
this be the intent in scientific communication. 

Educators and practitioners have been wonying 
about the antagonism that could be created by 
anthropomorphizing computers. Some 
industries have gone so far as to forbid the use 
of the term "memory*' for processor storage 
within a computer. We wou'^ agree that there 
is a fine line to be drawn b 7een desirable, 
tasteful analogies and unde^ ^*able or 
overworked ones. We arc not bothered by this 
particular analogy (memory) and might argue 
for the use of a term such as ''engine" to replace 
jargon such as "processing control element" or 
"computer element complex." 

While we agree that computers should not be 
portrayed as human beings, we feel that 
language, learning, and technolonrv have always 
been intertwined. Technological advances build 
upon preceding technology: language and the 
content of analogies reflect the changing 
technology. We remember from our biology 
classes that mitochondria were called the 
"powerhouse of the cell." Powerhouse was an 
analogy built upop the industrial revolution. 
Today, RNA is referred to as a computer tape: 
the program i*^ simply copied from the tape 
XRNA) to the new cellular matter (protein). 
This analogy reflects the new technology just 
as languac^e has always done so. 
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An Empirical Study of 
Analogy and Person 
Within Computer 
Documentation 

Traditionally, computer documentation 
mirrored the conventions within scientific 
discourse: objective use of language, passive 
voice, third person construction, no analogies 
to commonplace items. This is changing and is 
no longer the rule, although the struggle to 
insert stylistic components to aid human 
comprehension and lead to readability is 
ongoing. 



We have a rich history and an intuitive feel for 
the use of language from which to draw in this 
struggle. However, there has been little 
quantitative research to study or support this 
intuitive expertise. Our pilot study could serve 
to fill this gap and to inspect our hypotheses. 



Hypotheses 

We started out with the following hypotheses: 
Main Effects on Comprehension: 

1. Comprehension as measured by recognition 
will be higher than comprehension as 
measured by recall (across all stylistic 
versions). 

This we know from prior educational 
research. This would also seem to be 
intuitively evident since cued retrieval 
should be easier in any case than retrieval 
that is not cued. 

2. Analogy will increase readers' 
comprehension (over no analogy). 

3. Second person construction will increase 
readers' comprehension (over third person). 

Interaction Effects on Comprehension: 

4. Analogy will have a much stronger effect 
than person on comprehension. In other 
words, in the analogy condition, there will 
be no significant diiTerence in 
comprehension between the second and 



third person conditions. (The effect of 
analogy will override the effect of person.) 

5. The difference in recall scores between the 
analogy and the no analogy conditions will 
be greater than the difference in - 
recognition scores between the two 
conditions. In other words, while both 
recognition and recall will improve through 
using analogies, they are more important 
for recall than for recognition. 

We believe that by connecting new concepts 
to familiar, densely connected concepts in 
the reader's memory, the chances of 
successfully retrieving new information 
without being cued are greatly increased. • 
Thus analogies will be extremely effective 
for iion-cued retrieval. 

6. Second person construction will not have n 
greater effect on recall than on recognition. 
In other words, both recall and recognition 
will be improved to a similar extent. 

Main Effects on Preference: 

7. Analogy will be preferred. 

8. Second person construction will be 
preferred. 



Experimental Design 

Four Versions of Computer 
Documentation (Varying Analogy 
and Person) 

In order to test our hypotheses, we developed 
four versions of computer documentation 
covering the same conceptual content: 

Version 1 « analogy and second person. 

Version 2 « analogy and third person. 

Version 3 = no analogy and second person. 

Version 4 = no analogy and third person. 

We attempted to vary only analogy and person 
in these versions and, thus, to control for 
extraneous variables that could affect 
comprehension and preference. Figure 1 shows 
the difference between versions on several 
dimensions such as word count and readability 
levels. 
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Varsfon 1 Vorsion 2 Vorsion 3 Version 4 





102 


108 


105 


107 


Grade Lovel M 


9.2 


9.2 


9.6 


10.0 


Cloudiness Count 


1.7 


1.7 


4.0 


3.9 


Flesch Index mmx 


64.0 


62.0 


62.0 


60.0 


Fog Index 


12.5 


12.6 


13.4 


13.5 


Kincaid Index 


9.0 


9.5 


9.4 


9.9 


Syllables per word 


1.5 


1.5 


1.5 


1.5 


Uords per sentence 


19.2 


19.7 


19.3 


20.1 


• Mords 


977 


1007 


1006 


1045 


• prepositions 


153 


132 


144 


143 


• conjunctions 


61 


61 


64 


65 


• sentences 


51 


51 






• syllables 


1420 


14S0 


1489 


1563 


i abstracts 


7 


7 


25 


25 


i passives 


10 


10 


15 


16 


Acronyms 


RETURN 
ENTER 


RETURN 
ENTER 


RET 
ENT 
LU 
SUR 


RET 
ENT 
lU 
SUR 



» Grade level: 9.2-10.0 all fall within the "Operators" range. 

XM Cloudiness Count: 1.7 is "Easy"; 3.9 and 4.0 are "Fairly Easy." 

»»» Flesch IndQx: 64.0-62.0 all fall within the "Standard" range. 

60.0 falls within the "Difficult" range. 

Figure 1. Comparative Data on the Versions of Computer Documentation 

e split screen capability 
e terminars relationship to parent computer 



All ve/sions present the gist of the content in 
the 84. me order and explain the following basic 
computer concepts and devices: 

e di9*>lay screen 

e keyboard 

e moving to a new line 

e moving the contents of the display up and 
down 

e entering material into storage 
e saving material in files (data sets) 



e computer networks 

e sign*ons 

e sign-ofTs 

e networking function 

In versions 1 and 2« analogies are used to tie 
the new concepts to what we thought were 
concepts that an average person would know: 
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typewriters, windows, pages, dead sea bcroUs, 
filing cabinets, airlines, railroads. The Arabian 
Knights story, secret code words. Aside from 
using these items in extended analogies, we also 
retained words like ENTER and RETURN for 
function keys. Wh^n explaining the split 
screen capability, we used the word ''quadrant,* 
which could evoke the image of a 
cartesian-coordinate graph. 

In versions 3 and 4 we did not use any extended 
analogies. We also used ENT and RET for 
function key labels, as the words themselves 
could be construed as analogies. When 
explaining the split screen capability, we used 
the word ^'quarter.*' 

The four versions are included in ''Appendix A. 
Documentation.'' 

Two Comprehension Tests (Recall 
and Recognition) and One 
Preference Test 

To test for comprehension, we developed two 
questionnaires: one to measure recall and the 
other to measure recognition. Because of the 
different wording in the versions, we had to 
vary the wording in the questionnaires 
accordingly. Questionnaires la and lb are the 
recall questionnaires. They differ only in one 
word: la speaks of ^'files'' while lb speaks of 
'data sets.' Questionnaires 2a and 2b are the 
recognition questionnaires. They ask for the 
same concepts but in the different terminology, 
for instance 2a asks the meaning of 'port hole' 
while 2b asks the meaning of 'LU-to-LU 
connection' (two terms for the same concept). 
The questionnaires are included in 'Appendix 
B. Questionnaires.'* 

To test for preference, we developed a sheet 
asking the respondent to rank order the four 
versions according to preference. This sheet is 
also included in 'Appendix B. Questionnaires.' 

Format of Experiment #1 
(Comprehension): 2x2x2 Factorial 

Vfe used a 2 x 2 x 2 factorial design to test for 
the effects of analogy and person on 
comprehension as measured by the two forms of 
questionnaire. Thus, recall and recognition 
measures were treated as experimental 
conditions also, so that we could see if indeed 
the type of comprehension is differentially 
affected. 

Figure 2 shows our design. 



In order to test for the effect of analogy and 
person on comprehension of this basic material, 
we needed to contro* for prior knowledge. For 
our first pre-test, we selected a freshman class 
and a continuing-education class, both at 
SUNY-Albany. One of the authors 
administered the test at both classes. Students 
who had prior experience or knowk Ige of 
computers were asked not to participate. . 

Each student was given one version of the 
material and one version of the questionnaire. 
One of the authors handed out the material to 
the pre-selected students in alternating order, 
in an attempt to get an equal number of 
subjects per cell. Following each version was 
another passage of material administered as an 
intervening task. Students were directed to 
read the material in their packet (in sequential 
order) at the beginning of class. As they 
finished reading, the material was collected. 
Students were directed to keep tie envelope 
that was attached to the versions. Just before 
the end of class the students were directed to 
complete the questionnaire contained in the 
envelope. The author then collected the 
completed questionnaires. (Classes were 2-1/2 
to 3 hours long, so this was a delayed post- test.) 

The questionnaires were scored by the authors 
on the following scale: 0* incorrect, 
1=* partially correct, 2 » completely correct. We 
coded th^ di^ta with dummy variables in order 
to be able to use a regression procedure to 
analyze the effects of the main factors and the 
interactions between the main factors. 

Format of Experiment #2 
(Preference): 2x2x4 Factorial 

We used a 2 x 2 x 4 factorial desigii to test for 
the effects of analogy and person on '^rence. 
Since each of the subjects in this design would 
be looking at all four versions, we controlled for 
the effect of order by distributing the versions 
in four different orders. (The last version read 
might seem easiest because of increased 
familiarity with the material from reading the 
prior versions. Or, just the opposite, it might 
seem obnoxious because of reading similar 
content three times already.) 

The order conditions were as follows: 

Order 1 = Version 1, version 2, version 3, 
version 4 

Order 2 = Version 2, version 4, version 1, 
version 3 
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SECOND PERSON 


•THIRD PERSON 




Recall 


Recognition 


Recall 


Recogniti on 


ANALOGY 


4 


4 


4 


4 


NON-ANALOGY 


4 


4 


4 


4 



Figiire 2. Number of Subjects per Cell for First Comprehension Pre-test 



Order 3 - Version 3, version 1, version 4, 
version 2 

Order 4 » Version 4, version 3, version 2, 
version 1 

Note: Each version occupies first, second, 
third, and fourth places in one of the order 
conditions. 

With Experiment #1, v«e wanted to test for 
comprehension, so we had to control for prior 
knowledge and test people who would be called 
^naive users'* within the computer industry. 
Our interest was in testing for the effect of 
analogy and pers jn on learning. In Experiment 
#2, however, we wanted to look at the 
preference of experts within the field, people 
steeped in the traditional conventions within 
this area of discourse. Some have argued that, 
while analogy and second person might be 
better for naive users, it is not preferred by 
highly sophisticated users, even when these 
users are reading outside their field or sphere of 
knowledge. Perhaps their education has lead 
them to feel that clear writing is somehow an 
inrult; they want to be challenged to 
understand. However, we would argue that 
level of knowledge does not change human 
cognitive proces^.s. Anyone reading beyond 
their field of expertise is a naive user. What 
constitutes an apt analogy might change with 
different audiences, but the effectiveness of 
analogy in general as a stylistic aid to 
comprehension should not. 

One of the authors administered the preference 
test to 14 computer programmers within a 
particular ':;ompany. This was a convenience 
sample, poministered to programmers who 
happened to be in their offices when the at.thor 



stopped by. Twelve of the 14 programmers 
completed the questionnaire and reported their 
preference rankings over the phone to the 
author the next day. Figure 3 shows the 
number of subjects per order condition. 

We coded the data with dummy variables so 
that we could use a regression procedure to 
analyze the effects of the treatments and the 
interactions between those treatments and the 
order placement. Figure 4 shows how we 
blocked the ceding. 



Results 



Discussion 

Our first experiment tested the first six of our 
hypotheses (all but those involving preference). 
We found the following: 

1. Comprehension scores were significantly 
higher for subjects given recognition tests 
than for those given recall tests (see Figure 
5). Thus our first hypothesis was supported. 

2. Using analogies increased our subjects' 
comprehension scores overall (see Figure 5). 
Thus our second hypothesis was supported. 

3. Second person construction did not seem to 
affect our subjects' comprehension 
significantly (see Figure 5). Thus our third 
hypothesis was not supported. 

4. As with our finding of no main effect of 
person on comprehension, we also did not 
find a two way interaction effect of person 
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Order 1 


Order 2 


Order 3 


Order 4 


Number of 












3 


3 


3 


3 


Subjects 











Figure 3. Number of Subjects per Cell for First Preference Pre-Test 



on aggregate comprehension in the analogy 
condition (see Figure 6). 

However, notice that subjects tested for 
recall in the analogy condition scored quite 
a bit higher when their documentation was 
in written in second person than when it 
was written in third person (see Figure 7). 
The results are not significant at the p».05 
confidence level, however, this could be a 
result of the small sample size in this 
pre-test We intend to look more closely at 
this during our full test. These results 
would seem to imply that our original 
hypothesis is incorrect. That is, analogy 
does not override the effectiveness of 
person. Thus, our fourth hypothesis was 
not supported. 

5. The difference in recall scores between the 
analogy and the non-analogy conditions 
were greater than the difference in 
recognition scores between the two 
conditions (see Figure 8), but they failed to 
differ enough to reach statistical 
significance. However, with this small 
pre-test the findings look promising and we 
will certainly study the matter further in 
our full test. Note also the differences 
shown by the three«way interactions in 
Figure 7, 

6. Second person construction did not show an 
effect on comprehension scores, aggregated 
from recall and recognition tests (see second 
hypothesis). Neither did we find any 
differential effect when we looked 
separately at second person's effect on 
recall and on recognition (see Figure 9). 
Because there is no effect shown, it appears 
that our sixth hypothesis was supported. 
However, we cannot truly conclude that 
this is so. Because comprehension did not 
seem to be affected by second person at all, 
we could not truly test our sixth hypothesis. 

7. Programmers seemed to be indifferent to the 
use of analogy overall (see Figure 10). 



Therefore, our seventh hypothesis was not 
supported. 

8. Progranuners preferred texts written in 
second person over those written in third 
person (see Figure 11). Therefore, our 
eighth hypothesis was supported. 

Conclusions 

Pragmatically speaking, the most interesting 
finding from our first experiment is that the use 
of analogy in computer documentation could 
mnke it easier for users to recall information. 
We believe this is important, for much of * 
computer usage is dependant upon recall, not 
recognition. Users generally are happier with a 
system when they do not have to continually 
consult documentation in order to perform a 
task. In command driven systems, recall is 
especially important 

Our second experiment was designed to test the 
argument that highly skilled computer users do 
not like documentation that employs analogy. 
While we did not find a strong preference for 
analogy, neither did we find any objection to it. 

It is interesting to note that the order effect 
was highly significant (see Figure 11). That is, 
programmers tended to prefer the first version 
they saw. This implies that programmers, as a 
class, are not strongly attached to any one style 
of writing. 

In conclusion, we found no support for the 
contention that programmers might be hostile 
to the use of analogy in computer 
documentation^ Programmers seemed to prefer 
documentation written in second person over 
that written in third person. Therefore, we 
conclude that technical writers should consider 
using analogy and second person to improve the 
usability of computer documentation. We 
contend that these stylistic devices do increase 
comprehension without antagonizing the expert 
user. 
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^''^ *• D-ign for Coding iteaults of First Preference Pre-TesT 
Recommendation 



S! SSl .7* ""^^^^ trends in 

^ very nialj pre-test encourages us to 

contmue the study. We intend to correct 

•everal ambiguities we found in testing the 

version, ud questionnaires and to conduct a 

^'•«^?»tudy We feel that only bv 

wpeatmg the study with much larger s'amples 



result? ^^'^ ^ comfortably generalise our 
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25 -I 



20 - 



15 - 



10 - 



5 - 



Analogy 



Mean* 
(12.44) 



No 

Analogy 



Mean- 

(7.88) 





Style 
(Significant) 

'Significant difference, p < .05 



Person 
(Not significant) 



Test Form 
(Significant) 



Figure 5. Experiment 1: Main Effects of Analogy, Person, and Test Form 
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Comprthtnslon 
Seor* 

25 -1 



20 - 



15 - 



10 - 



5 - 



Second 
Person 



Mean'^' 
(12.88) 



Third 
Person 



Mean> 
(12.00) 



S^ond 
Person 



Mean* 

(8.38) 



Thiru 
Person 



Mean- 

(7.38) 



Analogy 
(Not significant) 



NO'Analogy 
(Not significant) 



Figure 6. Experiment 1: 2-way Interaction of Analogy and Person 
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(Net significint) 
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(Significant) 



'Significant difference, p < .05 



Figure 7. Experiment 1: 3-way Interaction of Analogy, Person, and Test Form 
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(Not signifiMnt) 
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(Not significant) 



Nota: Just misses significenct. with p • .0S9. 



Figure 8. Experiment 1: 2.way Interaction of Analogy and Test Form 
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Figure 9. Experin^jnt 1: ii-way Intei action of Person and Test Form 
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APPENDIX A. DOCUMENTATION 



VERSION . 



display screen. To start typing on a Sru^I J^^^"'^' "PP"'^ °n 

Just as you would on a typewriter ' ^ " P"""' labeled REn«N, 

cop:rd^Ji;?j^^:%"L^J:r;jrt:^^^^^^^ typ. mto a 

Rather, you can think of your text J * °* P'P*''' " * typewriter 

Dead Sea scroll than a »o^.m r.!.""? °° ""^ <>* P-P«. Bwre like a 
•crein acts like a window throu^ which JJS IJn i °* P'P"' "^^ display 
r«.ains stationary but you ca^ £ve tS JcroJ^f^ ^« «i»dow 

vi-w- -nd backward to change your 

On a typewriter, you use the roller to "scroll" ^k. 

co«puter. there are usually Progrw JL"oa PF? leSf*^'^"'"'* " baci«ard. On . 
the screen forward and backward Th.r. (PF) keys that you can press to scroll 

co«puter keyboard, and tSes. Sy. Si IsiltirifJ'i.^ T'"* ''"•^^•'^ "^^^^ " 
"typewriter" keyboard. Tlie keJ lablJl^ wi^ ff** t° '^^^"^ °* 
^ 7 labelled PF2 scrolls the screen JicJw'rd. "''' "•'^l' the 

When you type text and it aoDear* nn <-k. i 

-•an that your text has beeA "wrItSn" L^^^ '*°"»'t necessarily 

written onto your side of j^e linlT ?f ? ^ I ""J^* yo« type i, 

ENIIR that your new text "«te«" S^rou^J tJe'^J^r'^ T P"" •'•^ l-^SId 
•croll (In the computer 's »en,^JJ) . * ""^^ "^""^ "'^ ««ts written onto your 

^^^rgh^^•::t':n^w^'^?"^^^^^^ »>-ve .any -serous- of .ext 

letter to a friend. TTi. coa^ute"';!, iLr-Jc^fr-r « 
file in which to store your scroll il,. J?.!?! cos^uter the name of the 

on. in th. top left T.adi„t, on. 10"^ ?^ 5* "~' i«.t«ic., 

Kindow oporitu ..parat.ly ThJ J. .5"! ., »» t". cu., .ach quadrant or 
oa. scroll forward or bIcLrrS mi JnJ 'f!??" »°" ' "I""" »oro". You 

th. oth.r fU.,. In thS ,„ " fi .croilln, forward or bactoard IT 

«a^I.. loo. at four .uZ^^/ZlZ^. ^/^l'^^ I'^TtSi" 

»:t'3";Tt\Sin«^^^^^^^^^ sittonT 

the airlines, the actual travelling takes place 
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in the air, not at the airport teroinal. Similarly, the actual processing and 
storing of your material doesn't take place at your computer terminal. Rather, your 
terminal is the end point through which you communicate wich the computer. 

The airlines tie together a network of cities. As one airplane can take you to many 
different cities, sometimes one terminal can be used to communicate with several 
different computers. If your computer is tied together with a number of other 
computers by a network of communication lines, your terminal could conceivably act 
as a "port" to any one of them. 

In order to communicate with several different computers, your terminal must have a 
PORT HOLE into each. This port hole is a special tjrpe of internal definition, or 
door, that allows your terminal to communicate over the lines to the computer 
attached at the other end. Your terminal must have a unique defined port hole for 
each computer with which you want to communicate. 

The way that you open a port hole is by SIGNING ON to it. Each port hole has its 
own specific unique sign on code. Like Ali Baba gave the right sign ("Open Sesame") 
to open the secret door in the mojntain, you must give the right sign to open a port 
hole. Normally, only one port hole can be opened at a time. Therefore, you must 
SIGN OFF to close the opened port hole before you can sign on to another one. 

However, if your parent computer has what is called a SWITCHER function, you can 
switch back and forth between sessions with different computers without having to 
sign off and sign on each time. 

The switcher works like a railroad switchman. The railroad tracks leading in 
different directions do not move, but the switchman sets the ties to send the train 
along one specific path. Similarly, the switcher on your computer maintains all of 
the open port holes to the different computers in the network. You sign on only 
once to the switcher itself and then you can move directly back and forth between 
port holes and thus save yourself time. 

This could be especially useful if you have a display screen that is capable of 
being split. Tarough using the switcher, you could see through port holes to 
different computers at the same time. For instance,, on the top half of your screen 
you could look at a file stored on one computer while at the bottom half of your 
screen looking at anoth .* file stored on a different computer. 
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VERSION 2 

A computer display screen is soaethin* like a «h..i- 

the user types letters and numberrof ^h. "/ ? » * typewriter. As 

display screen. To st.« on J It uT^lt""" '^'^ 'PP'" o" ^''^ 

HETORN. Just « he/she woulfoa « Jyjewitir ' "'"^ ^^''•l*'* 

J c^r^r ie\Ten^:.:i::/-%^i^^^^^^^^ r r- ^- 

typewriter. Rather? the user cm thLI^f !J ! ' °* P'^"' " "^^^ ■ 
P-P«r, «,re like a Dead scrJ?l ! Jl' ''•^'^ " •*^»"°« « <>* 

The display screen acJs li"e ""L^i^/ ""J"?.'^^"^'^ "P""* °f P«Per. 

The Window stay, .tationary bit Sf^S H** *'^'''\^^* look at the sLSu. 

change the view. ^ ''"^ ""^^ '"oH forward and backward to 

On a typewriter, the roll«r e.i. 

there are usually ProS« L.:ti:i' PF '^JJ^Jhat^^^^^ " °» ' '^^"P"^"' 

screen forward and backward Thlr. -tl "'-^ Press to scroll the 

cooputer keyboard a^5 tl«; "Vf^^T ^"'^''^ labelled PF keys on a 

•Witer^^ keyS;arT key' aJe'Iirji ^ 

key labelled PF2 scrolls tJe sL.M Jic2w«J. "^"^ 

n'i::s.\':ir-.2?'tiJ"L"icrhaTb\« ^ ".^"'^'^ ••-"•^ 

user types'is written ^Sto ^J.' ou' .JdTo "hTlidr" Jj' .""^l" "f^". w^^-t the 
presses the- key labeled ENTER that "hi new t«t^f^" ''\t' """^^ 
writt«, onto the scroll (in th^ comJuJe^^; iS^ry^ 

i::t\"^;rTJ:hrb" l^W^^rs^^Sill.? : - ^-e .any "scrolls" of 

for a letter to% fri«.d. JJrcLut.r^aJSf tSJ %" ""^^'^ 

as a person would in a filia* cabS^t lt- kI! »"°11» i° separate FILES, just 

name of the file in which t^'st^JX",^^^- JJ" ~" tell the coapute'r 'the 

as a window to look at any on"orth. ful. To^o tt^ tl 

computer th. name of the Jile he/.J. w«t, io lie ^' '"^^ 

tru.T.^^^t^i^L^T;::k^-; ?:urjjjfei:°."ir^ ^"^-^ ^- 

instance, one in the top l.fj aladr«^ off ^ " ""^ ^^'^ ^or 

bottom ririit auadr*„t. * Vrr!"'/ " "e top right quadrant, one in the 

quadrant or window opirates^aJaSlv JJ!. !f '^^t'T: ^° 

.tori., of the ,«t.rl,l do...*! f!S I, ,k! Proc«.l„, .™| 
t.imiii.l i, u,. jodpolnt tti»u.h k f! '=°^"' t.i.to.1. R.th,r, the 
mm through ,hich the user cm co™r.lc.t. ,i,h th. coi,ot.r 

IV^JJJ-^^^^^^^^^^^^ people to 
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several different cooputers. If the user's computer is tied together with a number 

!L!S:Lir^"J'r comomaication lines, the terminal could 

conceivably act as a 'port" to any one of them. 

POR^hVlp^T"^"^' "JL? different computers, the terminal must have a 

Zr th?t -nJL! ; ^/»,P°" •'Ol' i« - "Po^i-l type of internal definition, or 
fni^hS L .J f^iJ '''' communicate over the lines to the computer i 

attached at the other end The terminal .uat have a unique defined port hole for 
each computer with which tarn user wants to cojmiunicate. 

The way that the user opens a port hole is by SIGNING ON to it. Each port hole 

specific unique sign on code. Like Ali Baba gave the right sign ("Open 
Sesame ) to open the secret door in the mountain. th» ,ser must give the rSht ^« 
to open a port hole. Normally, only on. port hole can be opened at a tim^ 
Therefore, the user must SIGN OFF to close the opened port hole before he/she can 
sign on to another one. 

However, if th3 parent computer ha* what i« called a SWITCHER function, the user 
can switch back and forth between ssions with different computers without having 
to sign off and sign on each time 

The switcher works like a railroad switchman. The railroad tracks leading in 
different directior • do not move, but the switchman sets the ties to send the train 
along one specific path. Similarly, the switcher on the computer maintains .11 of ' 
Che open port holes to the different computers in the network. The user signs on 
only once to the switcher itself and then he/she can move directly back and forth 
between port holes and thus save tlm*-. 

This could be especially useful if the user has a display screen that is capable of 
being split. Through using the switcher, the user could see through port holes to 

different cooputers at the sam» time. For Instance, on the top half of the screen a 
the user could look at a file stored on one computer while at the bottom half of the S 
screen looking at another file stored on a different computer 
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VERSION 3 



f 

\^X^ZrTll^^ 'k"" °° ' "^^^^ - =°»P""^ keyboard. As you 

SJo^'^^I^mti!?^?^ ^' """^^^ 12 inches square. What you type 

you want to. The text that you type in i» stored as a continuous piece of material 
J^dS" 5;rJS:? • °' «>ve backward to s« Jji- 

X'wh^e'yoTL'ded" ^'^^ ^° "--^ 

w^h^^n""!! '•^'Pl*^ backward. On the 

JS^crin usually Program Function (PF) keys that you can press to move 

the screen forward and backward. There are usually twelve labelled keys on^a 
computer keyboard, and these keys are usually xocaied on the right of tS co^SuJer 

PFZ scrolls the screen backward, 

""TJt 'PP"" °'' ^^'^ '•^'Pl'y ^l*" doesn't necessarily 

mean that your text has been stored. R«ther. what you type is jusc displayed on 

stored away in the coopufir's memory. 

I?!h^*" "!\^*'* computer to create many different text documents. For example, you 

" ^"^l^'** P'P" ^l'"' type a letter to a f^d Jou 

can do this with t-^ computer by using separate data si?., one for the te^^aper 
^d on. ror the lec.er. You tell the computer to store the different documeSS L 
!S?rJ 5 ! ^•ll ^^"^ computer th. name of thr data set in 

T^f-^ o^ "P °* t**' data sets by name to 

look at on your display scruen. 

Some computer display screens can be split into several different sections. That 
is you might be able to look at four different di.ta sets at the same time, for 
instance one in the top left quarter, one in the top right quarter, one in the 

5 ! °P""" separately. That is. each section looks into a 

fo™IJd „ !! ""^ backward in one data set without moving 

forward or backward in the other data sets. In this way. you could compare four 
different data sets to. for example, look at four different chapters oTa 
tne sane tine » 

The computer unit that you see and work with, which consists of the display screen 
and the keyboard, is called a TERMINAL. This terminal is an input/ou?put device 
which means that you can use it to put information into the computer or io get 
information OU-. When you are using your terminal, you don't have to be aware that 
?J communicating with the central computer unit. However, it is the 

b:n;Jir.J:/"f''T,'°"'!'* '° ^°°«' P^l'-P'. i° mother 

building, that actually reads, processes, and stores your material. 

Several different computers can be connected together into a "network." Networks of 
computers are created by attaching each one to She other by communStion iH \\ 
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your computer is tied together with a number of other computers by s network of 
coBounication lines, your terminal could conceivably be used to communicate with any 
on6 of thttiB. ' 

}n°Tn\ur^Sn^!'^^''^''^ different computers, your terminal oust have an 

LU-TO-LU CONNECTION with each. This LU connection is a special type of 
internal definition, that allows your terminal to communicate over the lines to the 
computer attached at the other end. Your terminal most have a unique defined LU 
connection for each computer with which you want to communicate. 

The way that you make use of the LU connection is by SIGNING ON to it. Each LO 
connection has a specific unique sign-on procedure which it expects of you. In 
order to be allowed access to a computer through an LU connection, you must type in 
the correct sign-on information. If the information is correct, you will then be 
able to use the computer at the other end of the LU connection. Normally, only one 
LU connection can be used at a time. Therefore, you must SIGN OFF of the LU 
connection you are using if you want to sign on to the LU connection for another 
computer session. 

However, if your parent computer has what is called a SWR function, you can go back 
and forth between LU connections with different computers without having to sim off 
and sign on each time. ^ 

The SWR works in a unique way. Tie SWR has many more LU connections than a terminal 
can have. Therefore, the SWR can have several LU connections for each computer in 
the network, all set up at the same time. Therefore, at any time, the SWR in your 
parent computer has open ties of communication with the entire network. You sign on 
only once to the SWR itself and then you can move directly back and forth between LU 
connections and thus save yourself time. 

This could be especially useful if you have a display screen that is capable of 

! u "»^8 SWR, you could use the LU connections to communicate 

with different cooputers at the same time. For instance, on the top half of your 
screen you could look at a data set stored on one computer while at the bottom half 
of your screen looking at another data set stored on a different computer. 
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VERSION 4 



scr.«i. To start tvDln.T; I M" ^ "-.'^"'"P«« Iceyboard. they appear on the disDlAv 
located on the righrsiSe trk^JS^IrJ """" R^T. ^ 

The computer display screen is usually about 9 « 19 . w 

types into the computer is stored"„aJ iTlLl I J^^"*^''" Wh" the user 

again if ,o desired. The text th-t ^^^^^^ the material 

Pl.ce of material. If tSe "er Jjs ti^ef?; 'T' " " continuous 

-ove bacl^ard to see what w^s ^yji; SJ'^efL;?. / 1°' °' 
«>ve forward, to get bacK to th^p1;ce^^eT^i;;hre^d:d^ " 

Ji'^o:s.":h^:\'jet^:i;ir;jog°;^^^^^^^^ « '>-ward. on 

to move the screen forward and baS ^er^ -i^ P"»» 
on a computer keyboard, and these Svrar.u!.!!i? i""^^y '"'^^^ 1-belIed PF key. 
computer keyboard. Th^ key fabeJle^JFt sc^^ti l^K °" 'he 

labelled PF2 scrolls the sere" backw«i. 'he key 

!^c«s\';i;^^^2'"at''Se"«t"haTr" °" ^^^'^^-^ '^at doesn't 

displayed L the s«een It is "t iL'irth': ' '''^ '^P" i» Just 

the new text is stored -way i:;%hTc^i!e?: ZZr^'.^''"' """^''"^ 'hat 

S: ::e" :"h^ait^:°^""L^'^E":Hs:r sample, 
friend. The user can do^Ws wUh jLi'^ '^P" " 1«'« to V 

the term paper and one fo^ tJe^U^teJ S"us« Luf ?h"''""' ^« 
different documents in the different d.t.!.^! ^ computer to store the 

name of the data set in which t^sSre t". twi ^ '^'"P"'" 
Of the data sets by name to look « o„ tJe S^Jiay'^L;"' "'^ 

instance, one i^ the top left a^rt« Z Ji«"«nt data sets at the same time, for 
bottom ririit ouarfr. .'h "I ll'l./rr* " '^ight quarter, one in the 

quarter of the displiy^perates siSL^if^ S^' ^" '^is case, each 

separate data set. The Ss" cL^JI into a 

-ving forward or baSJa^rL'^l^thVr^™"^.^^'"^^^^^ "^''"-^ 
compare four different data sets to for , ? ^^^l ""^l '^ou''^ 

« book at the same time. ' «««»Pl«. look at four different chapters of 

^reeTL"r^hr;:ySa"d:'L"::n:r: terminal"''?;/'''^' «*^»pi-y 

device which means that th^ "„ caJ use to n...^ I '"""""^ input/output 
to get information out. Whe^:si^^t^e teL^naf ^H "^'^ ^^"^ '^°'»P"'« 

trc:;t%:r-;;: ^s:^^.'^.'^^^^^ trc^ ;afX" ^^^^^ 'z::^^^ 

building, that ^^^idTploi^^^^^^^^ - -other 

X^";rra^^":;e^t^T^r:t. :s:i;; ::cTrtrf::^^^"^° - 

y «icning each one to the other by communication lines. If 
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the user's computer is tied together with a number of other computers bv « network 
of communication lines, the user's terminal could conceivably be used to communicate 
witQ any one of them. 

fu*??M^%*r?Z?rTV«V^^''v"''*"^ different computers, the terminal must have an 
LU-TO-LU CONNECTION with each. This lU connection is a special type of 
internal definition, that allows the terminal to coomiunicate over the lines to th^ 
computer attached at the other end. The teriainal must have a unique defined LU 
connection for each computer with which he/she wants to communicate. 

The way that the user makes use of the LU connection is by SIGNING ON to it 
Each LU connection has a specific unique sign-on procedure which it expects of the 
user. In order to be allowed access to a computer through an LU connection, the 
user must type In the correct sign-on Information. If the information is correct, 
the user will then be able to use the computer at the other end of the LU 
connection. Normally, only one LU connection can be used at a time. Therefore, the 
user must SIGN OFF of the LU connection he/she is using if he/she wants to si^ on 
to the LU connection for another computer session. 

However, if the p-rent computer has what is called a SWR function, the user can go 
back and forth between LU connections with different computers without having to 
sign off and sign on each time. 

•Hie SWR works in a unique way. The SWR has many more LU connections than a terminal 
can have. Therefore, the SWR can have several LU connections for each computer In 
the network, all set up at the same time. Therefore, at any time, the SWR In the 
parent caaq>uter has open ties of communication with the entire network. The user 
signs on only once to the SWR itself and then he/she can move directly back and 
forth between LU connections and thus save time. 

This could be especially useful if the user has a display screen that is capable of 
being split. Through using the SWR. the user could use the LU connections to 
communicate with different computers at the same time. For instance, on the top 
half of the screen the user could look at a data set stored on one computer while at 
the bottom half of the screen looking at another data set stored on a different 
computer . 
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QUESTIONNAIRE 1A: RECALL FOR VERSIONS 1 AND 2 

1. You are typing material onto your display screen. How would you move to the 
next line? 

2. You've been typing for five ninutes and your screen is full, but you still have 
more inforaation to type in. What would you do next? 

3. You have finished typing and you are now ready to store your text in the 
cooiputer. What must you do? 

4. You want to look at some text that you saved last week. What must you tell the 
computer if you are to see this text? 

5. You would like to look at four files at the same time. What capability would 
your computer need in order for you to do this? 

6. What device does the computer use to take in and put out information? 

7. In order for you to communicate with several different computers, your computer 
display device must have a with each computer. 



GO TO NEXT PAGE. DO NGJ RETURN TO THIS PAGE. 
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* 8. Yo«i wfiit to commmicate with computer A. How do you open this connection? 



9. You have been using computer A. Now you want to use computer B. What must you 
do? 

10. Your computer has a special function which makes it easier for you to go back 
and forth when communicating with several different computers. What is this 
function called? 

11. Last week you wrote a letter to your congressman and stored it in computer A. 
You've ruci^ived a responding letter and it is scored in computer 6. You would 
like to see both letters on your -'.isplay screen at the same time in order to 
mckB sure all your questions have bee . answexed. What two functions must your 
computer have to make this possible? 



STOP. DO NOT GO BACK. TURN IN YOUR ANSWERS. 
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QUESTIONNAIRE IB: RECALL FOR VERSIONS 3 AND 4 

'• '-'""pw .«..„. Ho. ,ou „v. t, .h. 

6. Wh.t ^„ ^^^^ ^ ^ ^^^^^^^^^ 

. witn eacn computer. 

GO TO NEXT ?AGE. DO NOT RETL.-, TO THIS PAGE. 
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«. You ««t to co-ualcat. «lth compufr A. Hew do you op« this connection? 

9. You h.v. b.„ using co-^ufr A. No« you ««»t to u.. coo^ufr B. Wh.t .n«t you 

«ik. .ur. .11 your question, h.v. b.« LJ^^S. wJ« ^ fJi^Jii."^'! 
coaputer h.v. to ^.k. this po..ibl.7 ^ function, nut ya r 



STOP. DO NOT GO BACK. njRN IN YOUR ANSWERS. 



AppMidlx B. Que.tionn.ires 39 



l ERLC 



29 

Preliminsn- Report: A Stw , of An.logy and Person in Computer DocumenUtion 69 



QUESTIONNAIRE 2A: RECOGNITION FOR VERSIONS 1 AND 2 

1. What Is the RETORN key on the computer keyboard used for? 

2. What happens when you press the PFl key? 

3. What is the ENTER key used for? 

4. What is a FILE? 

5. What doo, the SPLIT SCREEN capability allow you to do? 

6. What does a conputer nead a TERMINAl for? 

7. What Is f. PORT HOLE? 

8. What Is a SIGN-ON? 

9. What Is a SIGN-OFF? 

10. What do48 the SWITCHER function do? 

11. If you were using both the SPLIT SCREEN and the SWITCHFR *k 

would you be doing? SWITCHER at the saae tine, what 

STOP. TURN IN YOUR ANSWERS. 
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QUESTIONNAIRE 2B: RECOGNITION FOR VERSIONS 3 AND 4 

1. What is the RET key on the cooputer keyboard used for? 

2. Vniat happens when you press the PFl key? 

3. What is the ENT key used for? 

4. What is a DATA SET? 

5. What does the SPLIT SCREEN capability allow you to do? 

6. What does a cooiputer need a TIRNINAl for? 

7. What is an LU-to-LU CONNECTION? 

8. What is a SIGN-ON? 

9. What is a SIGN-OFF? 

10. What does the SWR function do? 

11. If you were using both the SPLIT SCREEN and the SWR at the ssffle time, what would 
you be doins? 

STOP. ITJRN IN YOUR ANSWERS. 
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QUESTIONNAIRE 3: PREFERENCE 

l^lllr',iZ\ryT^^^^^ "-^"^ documentation and then ran. order 

1. First choice (best version): 

2. Second choice (2nd best): 

3. Third choice: 

4. Last choice (worst version): 
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